Array.unshift()

Доступность

Flash Player 5.

Синтаксис

my_array.unshift(value1:Object,value2,...valueN) : Number

Параметры

value1,...valueN Одно /или более/ число, элемент или переменная, которая должна быть вставлена в начало массива.

Возвращает

Целое число, представляющее новую длину массива.

Описание

Метод; вставлет один /или более/ элемент в начало массива и возвращает новую длину массива.

Пример

Пример, который демонстрирует применение Array.unshift():

var pets_array:Array = new Array("dog", "cat", "fish");
trace( pets_array ); // dog,cat,fish
pets_array.unshift("ferrets", "gophers", "engineers");
trace( pets_array ); // ferrets,gophers,engineers,dog,cat,fish